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0 .  INTRODUCTION 

The  Time  Series  Editor  is  a  collection  of  FORTRAN  programs 
controlled  by  a  master  program  called  TIMESER  EXEC  in  the  CP/CMS 
executive  language.   The  package  has  been  designed  for  the 
analysis  and  forecasting  of  time  series  data  using  the  Box-Jenkins 
modelling  methodology.   For  a  complete  description  of  the  Time 
Series  Editor,  see  Richards  and  Woodall  [Ref.  16].   This  Guide 
contains  the  minimum  information  that  is  required  for  the  user 
to  access  the  Time  Series  Editor,  enter  data,  build  a  model, 
evaluate  the  model,  forecast,  and  obtain  output. 

1.  DATA  INPUT 

The  Time  Series  Editor  requires  that  time  series  data  be 
entered  into  the  sequential  FORTRAN  input/output  file  named 
FILE  FT02F001.   This  can  be  done  either  online  or  via  cards 
read  offline.   The  following  page  shows  the  proper  card  deck 
arrangement  for  reading  data  offline.   The  data  deck  must  be  given 
to  the  computer  center  system  operator  for  entry  into  CP . 

If  the  user  has  a  data  deck  already  punched  up  in  a  format 
other  than  5F15.6,  he  may  enter  the  series  as  above  into 
FILE  FT03F001  (without  the  length  of  series  card)  and  use  the 
Editor  program  ZFORMAT  to  transform  it  into  the  FILE  FT0  2F001 
in  the  proper  format,  without  destroying  his  original  file. 
This  program  is  described  in  the  next  section. 
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II.   TABLE  OF  OPTIONS 

This  Table  provides  the  user  with  the  basic  information 
necessary  to  understand  the  data  requirements,  functions 
and  output  options  for  each  program  in  the  Editor. 
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III.   THE  BASIC  USER  SESSION 

To  use  the  Time  Series  Editor,  the  user  must  log  into 
CMS,  get  into  CP,  link  to  the  disc  storage  area  where  the 
Time  Series  Editor  resides,  reimplement  CMS,  log  into  the 
general  user  and  Time  Series  Editor  disc  areas,  and  enter 
the  TIMESER  routine.   This  section  will  provide  explicit 
guidelines  to  enable  the  user  to  perform  the  above  steps 
on  the  NPS  CP/CMS  system.   Commands  marked  with  an  asterisk 
(*)  are  those  actually  entered  on  the  terminal  by  the  user 
(the  asterisk  itself  is  omitted) .   Those  without  an  aster- 
isk and  those  written  in  all  capital  letters  are  system 
responses  at  the  terminal.   Numbered  sentences  are  comments, 
which  will  not  appear  during  an  actual  user  session.   The 
instructions  and  system  responses  assure  the  user  is  on  an 
IBM  2741  Input/Output  Terminal.   Some  minor  modifications 
may  be  necessary  if  other  terminals  are  used. 


1.  Turn  the  terminal  on,  depress  the  BREAK  key,  and  wait 
for  the  system  to  respond: 

CP-67  online  xd.65   gsyosu 

2.  Depress  the  ATTN  key.   The  roll  bar  will  advance  and 
the  keyboard  will  unlock.   Then  enter: 

*login  aaaapbb  450k 

3.  aaaa  is  the  user's  identification  number,  and  nn  is  the 
terminal  number  (usually  written  on  the  terminal) . 

For  example,  if  the  user's  ID  number  is  1621  and  the 
terminal  number  is  44,  the  input  would  be: 
login  1621p44  450k.   The  addition  of  450  k  to  the  normal 
login  command  is  necessary  to  execute  the  program 
WMARQRDT  in  the  Editor;  for  users  not  planning  to 
execute  this  program  during  a  session,  this  addition 
is  not  necessary. 


4.  The  system  will  respond  with  the  statement: 
ENTER  PASSWORD: 

5.  The  user  then  enters  his  password,  or  the  general  users 
password  npg; 

♦password 

6.  The  system  will  then  respond: 

ENTER  4-DIGIT  PROJECT  NUMBER  FOLLOWED  BY  4 -CHARACTER 
COST  CENTER  CODE: 

7.  The  user  then  enters: 
*gggghhhh 

8.  gggg  is  the  assigned  project  number,  and  hhhh  is  the 
user's  section  designator  or  the  faculty  code. 

9.  The  system  will  respond  with  the  message  of  the  day, 
such  as: 

CP/CMS  HOURS  ...  0930=2200 (MON-THURS)  ...  0930-1800 (FRI) 
OUTPUT  RETAINED  5  DAYS 
Cms  Version  3.25 

10.  At  this  point,  the  user  is  in  CMS.  He  must  then  get  into 
CP;  this  can  be  done  by  hitting  the  ATTN  key.  The  system 
will  then  respond: 

CP 

11.  The  user  must  then  link  to  the  TIME  SERIES  EDITOR; 
this  is  accomplished  by  entering: 

*link  2069p  191  192 

12.  The  system  will  respond  with: 
ENTER  PASSWORD: 

13.  The  password  (read  only)  to  enter  the  Editor  is: 
*timser 

14.  The  system  then  responds: 
SET  TO  READ  ONLY 


14 


15.  The  user  now  implements  CMS  by: 
*ipl  cms 

16.  The  system  will  respond: 
CMS  Version  3.25 

17.  Now  the  user  must  log  into  both  the  general  user  and 
the  Time  Series  Editor  area  by  entering: 

*login  191 

18.  The  system  will  respond  with  a  message  such  as: 
R; 

19.  The  user  then  enters  the  command: 
♦login  192  t,p 

20.  The  system  will  respond: 

T  (192)  R/O 
R; 

21.  The  user  can  then  enter  the  Time  Series  Editor 
(guided  version)  by  entering  the  command: 

*timeser 

22.  The  system  will  respond: 

EACH  2  SECONDS  EXECUTION  TIME  IS  INDICATED  BY  * 

YOU  HAVE  ENTERED  THE  TIME  SERIES  EDITOR 

PLEASE  RESPOND  TO  EACH  QUERY  WITH  AN  INPUT  AT  THE  TERMINAL 
ENTER  ONLY  THE  FIRST  LETTER  FOR  A  WORD  RESPONSE. 
ENTER  NUMERICAL  VALUES  VIA  FORTRAN  FORMAT.. 

TYPE  INTEGER  VALUES  (RIGHT  JUSTIFIED)  FOR  NAMES  STARTING 
WITH  I  THROUGH  N.  TYPE  FLOATING  VALUES  WITH  DECIMAL  FOR 
ALL  OTHERS. 

DO  YOU  WANT  A  LIST  OF  THE  OPTIONS? 

23.  The  user  is  then  on  his  own,  guided  by  the  Exec  routine. 
See  the  notes  that  appear  at  the  end  of  this  guide  for 
additional  information.   Eventually  the  user  will  be 
asked: 

DO  YOU  WANT  TO  TRY  AGAIN? 
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24.  If  a  yes  response  is  given,  another  sequence  will  begin; 
if  the  response  is  no,  the  user  will  be  taken  out  of 
the  Time  Series  Editor  environment  and  returned  to  CMS. 
The  system  response  will  be: 

CONTROL  RETURNED  TO  CMS 

25.  The  user  can  then  log  out  of  CMS  by  typing: 
*cp  logout 

26.  The  system  will  respond  with: 

CONNECT=  00:08:02   VIRTCPU=  000:07.98   TOTCPU=  000.10.94 
LOGOUT  AT  14.22.04  on  10/16/78 

27.  The  user  should  then  turn  off  his  terminal  and  tear  off 
the  output  from  his  session. 


The  more  experienced  user  can  dispense  with  the 
"welcome  aboard"  section  of  the  Time  Series  Editor  and  get 
right  down  to  business  by  using  the  shortened  version  of  the 
Editor.   This  shortened  version  may  be  entered  by  linking  in 
the  normal  way,  and  then  entering  the  Editor  by  typing  the 
COMMAND 

*timeser  s        (asterisk  omitted) . 

The  system  will  immediately  respond: 

ENTER  LETTER  FOR  OPTION  YOU  WANT. 

The  session  inside  the  Editor  then  begins. 
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IV.   BRIEF  SAMPLE  USER  SESSION 

A  brief  sample  user  session  is  given  below;  it  includes 
copies  of  the  offline  output  generated  during  the  session. 
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repeat  login   nur@pn@ 

login  1621p44  450k 
ENTER  PASSWORD: 

ENTER  4-DIGIT,  PROJECT  NUMBER  FOLLOWED  BY  4-CHARACTER  COST  CENTER  CODE: 

0444rl72 

READY  AT  17.24.38  ON  09/16/78 

CMS  Version  3.25 

stat 

P  (191):  29  FILES;  241  REC  IN  USE,  55  LEFT  (of  296),  8.1%  FULL  (2  CYL) 

R; 

cp  q  f 

FILES:-  NO  RDR,  NO  PRT,  NO  PUN 

R; 

CP 

link  2069p  191  192 

ENTER  PASSWORD: 

SET  TO  READ  ONLY 

ipl  cms 

CMS  Version  3.25 

login  191 

R; 

login  192  t,p 

T  (192)  R/O 

R; 

timeser 

EACH  2  SECONDS  EXECUTION  TIME  IS  INDICATED  BY  *. 

YOU  HAVE  ENTERED  THE  TIME  SERIES  EDITOR. 

PLEASE  RESPOND  TO  EACH  QUERY  WITH  AN  INPUT  AT  THE  TERMINAL. 
ENTER  ONLY  THE  FIRST  LETTER  FOR  A  WORD  RESPONSE. 
ENTER  NUMERICAL  VALUES  VIA  FORTRAN  FORMAT. 

TYPE  INTEGER  VALUES  (RIGHT  JUSTIFIED)  FOR  NAMES  STARTING 

WITH  I  THRU  N.  TYPE  FLOATING  VALUES  WITH  DECIMAL  FOR  ALL  OTHERS. 

DO  YOU  WANT  A  LIST  OF  THE  OPTIONS? 

y 

OPTION  DESCRIPTION 

GENERATE  GENERATE  ANY  ARIMA  TIME  SERIES 

AUTO  CALCULATE  AUTOCORRELATIONS,  PAUTOS,  MEAN  AND  VARIANCE 

PLOT PLOT  A  TIME  SERIES 

ESTIMATE  CALCULATE  MAX  LIKELIHOOD  ESTIMATES  OF  ARMA  PARAMETERS 

DIFF DIFFERENCE  A  TIME  SERIES 

FORECAST FORECAST  FUTURE,  VALUES,  CONSTRUCT  CONFIDENCE  INTERVALS 

TRANS -"TRANSFORMS  VALUES  OF  A  TIME  SERIES 

ROOTS  DETERMINES  ROOTS  OF  ARIMA  CHARACTERISTIC  EQUATION  ' 

ZFORMAT  ALTER  DATA  FILE  TO  FORMAT  5F15.6 

CMSWORK  PERFORM  CP/CMS  COMMANDS  IN  TIMESER  EXEC 

SIMULATE  SIMULATE  NONSEASONAL  TIME  SERIES 

YESTSEAS  CALCULATE  INITIAL  SEASONAL  PARAMETERS 

WMARQRDT  MARQUARDT  SOLUTION  FOR  PARAMETER  ESTIMATES 

XSUMSQ  CALCULATE  SUM  OF  SQUARES  FOR  ARBITRARY  PARAMETERS 

WOULD  YOU  LIKE  MORE  INFO? 

y 
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ENTER  OPTION  YOU  WANT  INFO  ABOUT. 


AUTO  THIS  PROGRAM  CALCULATES  AUTOCORRELATIONS,  PARTIAL 

AUTOCORRELATIONS,  THE  MEAN  AND  THE  VARIANCE  FOR  A  GIVEN  TIME  SERIES 
WHICH  MUST  RESIDE  IN  FILE  FT02F001.   THE  PROGRAM  USES 

FTAUTO  IN  THE  IMSL  LIBRARY.   THE  AUTOCORRELATIONS  AND  PAUTOS  CAN  BE 
PLOTTED  OFFLINE. 


DO  YOU  WANT  INFO  ABOUT  ANOTHER  OPTION? 

n 

DO  YOU  WANT  TO  TRY  A  SESSION? 

y 

ENTER  LETTER  FOR  OPTION  YOU  WANT. 

c 

ENTER  DESIRED  CP/CMS  COMMANDS,  ONE  PER  LINE. 

WHEN  FINISHED  TYPE:  &GOTO  -QUES 

listf  *  £t02f001 

FILENAME  FILETYPE  MODE  NO.REC.  DATE 


SERG  FT02F001 

SERC  FT02F001 

LNSERG  FT02F001 

FILE  FT02F001 


PI       3     9/16 

PI       5     9/16 

PI       3     9/16 

PI       1     9/16 
erase  file  ft02f001 

alter  sere  ft02f001  pi  file  ft02f001  pi 
stat 

P  (191):  28  FILES;  240  REC  IN  USE,  56  LEFT  (of  296),  81%  FULL  (2  CYL) 
&goto  -ques 
DO  YOU  WANT  TO  GO  AGAIN? 

y 

ENTER  LETTER  FOR  OPTION  YOU  WANT. 

a 

IS  YOUR  DATA  IN  FILE  FT02F001? 

y 

EXECUTION  BEGINS.  .  . 

AUTOCORRELATIONS 


0.978      0.944      0.902      0.854      0.802      0.748      0.692      0.635 
0.468      0.413      0.359      0.305      0.253      0.201      0.150      0.098 
-0.052    -0.101    -0.151    -0.200    -0.248 


0.579   0.5*23 
0.047  -0.003 


PARTIAL  AUTOCORRELATIONS 

0.978  -0.260  -0.157  -0.093  -0.058  -0.045  -0.012  -0.038  -0.022  -0.010 
-0.036  -0.041  -0.038  -0.024  -0.037  -0.027  -0.032  -0.070  -0.048  -0.024 
-0.034  -0.061  -0.079  -0.048  -0.037 


KEAN=  22.9739 


VARIANCE  =   4.22273 


ENTER  TITLE  FOR  PLOTS. 

autos  and  pautos  for  series  c  data 
YOUR  AUTO  AND  PAUTO  PLOTS  HAVE  BEEN  PRINTED  OFFLINE, 
PICK  UP  IN  ROOM  1140  UNDER  YOUR  USER  ID  NUMBER. 

DO  YOU  WANT  TO  GO  AGAIN? 

y 

ENTER  LETTER  FOR  OPTION  YOU  WANT. 

c 

ENTER  DESIRED  CP/CMS  COMMANDS,  ONE  PER  LINE. 

WHEN  FINISHED  TYPE:  SGOTO  -QUES 

offline  print  file  ft02f001 

alter  file  ft02f001  pi  sere  ft02f001  pi 

igoto  -ques 

DO  YOU  WANT  TO  GO  AGAIN? 

n 

CONTROL  RETURNED  TO  CMS 

R; 
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V.   PROBLEM  CONTROL  NOTES 

This  section  will  cover  corrective  measures  that  can  be 
taken  when  things  fail  to  go  as  expected  while  in  the 
TIMESER  environment. . 

a.  A  typing  error  in  the  CMS  environment  can  be 
corrected  by  typing  the  @  character  as  many  times  as  is 
required  to  back  up   and  then  type  the  correct  values.   For 
example,  if  the  user  typed  timesre,  the  user  could  correct 
the  mistake  by  typing  two  @  signs,  followed  by  the  correct 
spelling  er,  as  follows:   timesre@@re.   An  entire  line  can 

be  deleted  by  typing  the  C  character  (or  [    on  some  terminals) 

b.  When  working  with  TIMESER  executive  programs,  the 
user  should  exercise  care  before  hitting  the  return  key  (or 
control  s  on  some  terminals) .   If  an  input  value  is  required 
and  the  return  key  is  hit  before  the  proper  response  is 
entered,  the  user  will  be  likely  to  get  thrown  out  of  the 
editor  and  have  to  begin  again.   In  most  cases,  errors  can 
be  corrected  only  before  the  return  key  is  struck  (in  some 
programs  you  get  a  second  chance  for  input) . 

c.  Particular  care  should  be  taken  for  integer  value 
input,  which  must  be  right  justified  in  the  format  field. 
The  editor  will  advise  the  user  in  all  cases  where  the 
integer  format  is  other  than  II. 

d.  If  for  any  reason  the  user  finds  himself  in  a  debug 
or  error  condition  (caused  by  erroneous  data,  or  a  "blowup" 
in  one  of  the  non-linear  optimization  routines  usually 
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caused  by  very  poor  initial  input  values) ,  the  following 
procedure  will  get  the  user  back  into  the  normal  TIMESER 
environment: 

(1)  depress  the  ATTN  key  twice;  this  gets 
the  user  into  CP;  hit  the  ATTN  key  again, 
and  then  type  kx  to  kill  the  execution. 

(2)  re-ipl  CMS,  and  login  191  and  then  login 
192  t,p. 

(3)  then  the  user  can  type  TIMESER  or  TIMESER  S, 
and  return  to  the  TIMESER  environment 

On  the  next  page  is  a  sample  user  session  where  an  error 

causing  a  debug  condition  has  occurred. 

Here  the  user  executed  a  program  that  required  data 

in  FILE  FT02F001,  and  the  FILE  did  not  exist.   As  the 

example  shows,  recovery  is  quick.   Simply  hit  the  break 

button  to  get  into  CP,  login  191,  login  192  t,p,  and  then 

type  timeser  s  to  return  immediately  to  the  Editor  environment. 
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